Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / ds320.arc / DS_READ.ME < prev next >

Wrap

Text File | 1989-02-09 | 28.1 KB | 494 lines

╔═════════════════════════════════╗ ║ Directory Scanner (tm) Ver 3.20 ║ ║ Copyright (c) 1986, 1987, 1988 ║ ║ by Nat Martino ║ ║ ALL RIGHTS RESERVED ║ ╚═════════════════════════════════╝ Presents a full screen display of the directory structure of a given disk drive. The display looks like the following: █████ Drive C ███████████████████████████████ C:\DIR2 ████████████████████████ █ c:\ █ backup .exe ║ finder .com ║ guts .zzz █ █ ├─ dir1 █ create .com ║ finder .exe ║ help .def █ █ ├─ dir2 █ dump .asm ║ finder .obj ║ killer .com █ █ │ ├─ sub1 █ dump .exe ║ guts .asm ║ print .com █ █ │ └─ sub2 █ dump .obj ║»guts .com« ║ qsort .exe █ █ └─ dir3 █ eater .bas ║ guts .exe ║ vdisk .sys █ █ █ eats ║ guts .obj ║ zoo .bas █ █ █ eatz .bat ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ █ █ ║ ║ █ ███████████████████████████████████████████████████████████████████████████████ Total: 10,456,123 │ Help=? Name ^ │ Files: 22 Used: 137,354 Tagged: 0 Used: 8 000,000 │ Free Core 146K │ ────name──── ──size── ──date─── ─time─ atr Free: 2,456,123 │ Drive 80% Full │ guts .com 17,123 10 Aug 85 4:36p r ─────────────────────────────────────────────────────────────────────────────── ┌────────────────────────────────────────────────┐ ──────────────┤ FILE COMPOSITION OF DIRECTORY SCANNER SYSTEM ├────────────── └────────────────────────────────────────────────┘ 1. DS_READ.ME - This read.me file 2. DS.EXE - The program which loads/reloads the main DS program. 3. DS_OVRLY.EXE - The main DS program. This file and all the following files should not be renamed. 4. DS_GLOBL.LOG - This file SHOULD NOT EXIST THE FIRST TIME YOU INSTALL THE PROGRAM. The program will create this file the first time the program is executed. This file contains various global variables which are passed between program modules and resides in the "home" directory where all the rest of the DS files reside. The "home" directory is specified with a "set DS=c:\ds" command in the user's autoexec.bat file. This file along with the "ds_drv_?.log" files replaces the "device driver" that was present in earlier versions of the program. 5. DS_DRV_?.LOG - The "?" represents an appropriate drive letter. This file (or files) SHOULD NOT EXIST THE FIRST TIME YOU INSTALL THE PROGRAM. The program will create the file the first time the program is executed so long as the user has specified that a "log" file should be maintained for a specified drive with the "Ctrl-E" option. Once a "log" file has been created for a specified drive, subsequent program startups and/or drive changes to that specified drive should take little time as the program will obtain the directory structure info from the log file instead of scanning the entire disk for the information. 6. DS_BKUP.EXE - The backup program which is activated from within the DS program by selecting the "b" option. This program is not a self sufficient program. It cannot be executed on its own and work properly. It expects to obtain directory structure information from an appropriately maintained DS_DRV_?.LOG file. 7. DS_HELP.EXE - The expanded context-sensitive help displays. The program is activated from within the main program by pressing the F10 key. 8. DS_INIT.EXE - This program is called by the main ds program to aid in displaying/changing macro definitions, the default editor and lister, and the directory to number linking. It also allows the user to change the list of which drives will have "log" files maintained on them. 9. DS_PROG.DEF - The program "defaults" file. This file contains data on the default startup colors, macro definitions, the defined editor and lister, the links of directories to numbers, and which drives should have "log" files maintained. 10. DS_USERS.MAN - A 21 page users manual. (66 lines/page) 11. DS_MOUSE.MSC - Source file for a Mouse Systems optical mouse device driver pop-up menu display. 12. DS_SITE.LIC - Information on site licensing of the program. 13. DS_SINGL.LIC - Information on single user licenses. ┌────────────────────────────────────────────────┐ ──────────────┤ INSTALLATION PROCEDURES ├────────────── └────────────────────────────────────────────────┘ Note: The following procedures make the assumption that you have a hard disk as drive "c" and boot up off that drive. 1. Make a subdirectory "DS" under the "C:\" (root) directory. 2. Copy all DS files to this new "C:\DS" directory. 3. Version 3.20 no longer uses a device driver as did versions 3.00 & earlier so if in your "config.sys" file of the root directory you have the following line, you should remove it: device=c:\ds\ds_drive.sys D:C 4. Remove any files from previous versions of the DS program to a backup floppy so that this new version will not attempt to use supporting files from previous versions. The "ds_prog.def" file from version 3.10 should be compatable with version 3.20 so you should not need to delete this file or re-enter all your macro definitions. A new "ds_prog.def" file has, however, been provided with this version to show some examples of the new macro options. 5. In "autoexec.bat" file of root directory have the following line: set DS=C:\DS The foregoing "set DS=pathname" command is MANDATORY to enable execution of the program. If it was not executed in the autoexec or directly at the DOS prompt prior to executing DS, the Directory Scanner program will not work. "C:\DS" should also be present in your PATH command Sample "autoexec.bat" entries follow: path c:\;c:\dos;C:\DS;... {"C:\DS" plus other user directories} dpath {shareware dpath program (optional) } set DS=C:\DS {sets HOME directory of ds files } ds {starts execution of DS program } Notes: a. "DPATH" shareware program is optional but useful to enable DOS to find overlay and support files the editor may need. b. A cursor/keyboard speedup program (like "hotkey" shareware program) is also highly recommended in your "autoexec.bat" file to speed up directory and file movement. c. Another entry that MUST be in your "environment" for the program to execute is the "COMSPEC=" variable. This variable is normally inserted in your "environment" automatically by DOS upon booting up the system. You can check to see that it has been loaded into the environment by typing "set" followed by a carriage return at the DOS prompt. You should see a line something like the following: COMSPEC=c:\command.com ┌────────────────────────────────────────────────┐ ──────────────┤ CURRENT PROGRAM LIMITATIONS ├────────────── └────────────────────────────────────────────────┘ MS/PC DOS 2.0+ Maximum number of fixed/hard disk drives supported/saved: 26 Note: The number of drives saved or "logged" is user-definable. Use the "Ctrl-E" option to enter the drive letters of those drives you wish to have logged. Floppy disk drives and RAM disk drives are not recommended to "log" as it takes little time to scan those type drives. Maximum number of directories per drive: 150 Maximum number of files per directory: 300 Maximum length of full pathname for any directory: 39 characters These limitations were chosen for no particular reason. The program can be recompiled extending these limitations, but with a consequent increase in the size of the program. The program currently takes up approximately 83K during execution. This does not include the backup option (which during execution takes up additional memory - but releases it upon termination of the option). ┌────────────────────────────────────────────────┐ ──────────────┤ RECENT REVISION HISTORY ├────────────── └────────────────────────────────────────────────┘ Ver 3.00 (8 Jun 87) - Modified Color Change options. Alt-K must be selected to enable color changes. This prevents accidental color changes which was annoyingly common in previous versions. Along with this change the "set DS=0F14" type command in the "autoexec.bat" file must be replaced with a "set DS=c:\ds" (without quotes) type command. The characters following the equal sign should specify the full pathname of the directory where the user has placed all the DS files. The pathname of the specified "home" directory should NOT end with a "\" so if the user places all DS files in the root directory of the "d:" drive, it would be specified as follows: "set DS=d:" (without quotes) - Added Alt-E option to enable toggling in and out of EGA 43-line mode. - Added support for macro definition and execution. Alt- F1 thru Alt-F9, Shift-F1 thru Shift-F9, and Ctrl-F1 thru Ctrl-F9 may be user defined to execute other DOS commands. Alt-F10, Shift-F10 and Ctrl-F10 are used to display/change macro definitions. Should future desired enhancements require some available keys, one set of the above keys (ie: all alternate-function keys) may be freed up for such purposes. - Add capability to link a directory to a number key or alt-number key sequence. After such linkage is made, depressing the single number key or alt-number key sequence will switch the directory display to the new directory. Selecting "0" or "alt-0" will display directory links and allow additions/deletions. - Added Ctrl-E option to enable user to define desired editor and lister program. Defaults are "edit" and "list" but may be permanently changed by the user. - Added "defaults" file support to provide for permanent user changes to most of the previous options. - Remember to change the "set DS=0FBb" entry in your "autoexec.bat" file to reflect the full pathname of the home directory for all the DS files. ie: "set DS=c:\ds" if the user has placed all the DS programs in the "c:\ds" directory. Ver 3.10 (05 Jan 88) - Replaced use of Device Driver (old "ds_drive.sys" file) with disk "log" and "global" files. User now has the option (within "Ctrl-E") to specify which drives to maintain a "log" file on. This change may slow the program down somewhat but has the following advantages: + Recovered 10K of memory by elimination of device driver. You can now take it out of your "config.sys" file. + Allows user to maintain up to 26 disk "log" files (old device driver only allowed 2). + Eliminates initial disk scan on program startup if a drive "log" file has been previously created. Use of a RAM drive as the "HOME" directory for the DS files can negate some of the delay encurred due to file input/output. - Expanded limits of program to accomodate a maximum of 150 directories per drive, and 300 files per directory. - Changed functions of F3, F4, F5, F6 directory movement keys to the following: + F3 = Move directory highlighter up one-half the screen. + F4 = Move directory highlighter down one-half the screen. + F5 = Move directory highlighter to root directory. + F6 = Move directory highlighter to last directory. - Changed "TAB <ltr>" command to work on tabbing to the first file whose filename begins with the letter entered after the TAB key is depressed. The old usage of tabbing to directories can be done better with the "directory-number links" options ("0" and "alt-0"). - Fixed file I/O problem with "ds_prog.def" defaults file. Certain color selections resulted in a "Ctrl-Z" (end of file) character being written to the file. Not all the file I/O routines accessed the file in a binary mode. They do now, eliminating the problem with encountering an end of file character. - Fixed problem of recording "HOME" directory of DS files. Program did not record home directory correctly if the user specified the root directory of a drive. For example, if the user specified "set DS=c:" in the autoexec.bat file for the root directory of the "c", the program did not record the home directory correctly. Hopefully it records it correctly now; however, I still recommend that users create a "ds" directory under the root directory and place all DS files in that directory. A "set DS=c:\ds" command would then be required in autoexec.bat file. - Fixed problem with "Illegal Interrupt No. 0Ah at ...." which was experienced mostly by AT&T 6300 PC's but also by some other models. - Added option 'Z' to toggle display/non-display of time. Time is displayed in the top border. This option is not fully implemented in its final form yet and has not been included in the user's manual. - Added option to allow arrow keys to do double duty as not only file movement keys but also as directory movement keys. Toggling the space bar will toggle the definition of the arrow keys from file movement to directory movement or from directory movement to file movement. If a left pointing arrow appears midway down the border between the directory and file screens, the arrow keys will then work on moving the highlighted directory. If no arrow appears in the border between the 2 screens, then the arrow keys work on the files. If desired, the space bar can be prevented from acting as a toggle key by pressing the 'Q' key. A second way of defining arrow keys is to use the Ctrl-Left or Ctrl-Right arrow. Ctrl-Left Arrow will define the arrow keys to navigate amongst directories, while Ctrl-Right Arrow will define the arrow keys to work on files. This option is not fully implemented in its final form yet and will change somewhat in the next version. - First attempt at installing code to support PS/2 MCGA and VGA 50 line mode. ALT-E Option should toggle PS/2 displays to/from 25/50 line display modes. There is not much display info readily available to me on PS/2 modes so keep the faith as it may take an iteration or two to get this code working correctly. I could use some help and/or feedback from PS/2 users on this one. Unfortunately I do not have access to PS/2 equipment so am working in the dark on perfecting display modes for PS/2s. - Added Ctrl-T option to create a "Tree Dump" file in the root directory of the current drive showing the tree structure of the disk. The name of the file will be "tree_c" if on "c" drive, "tree_d" if on "d", etc. - As this version of the program depends more heavily on successfully reading and writing global/drive data to files, the following procedure should be kept in mind. Should the user experience any hangups after initially successful use of the program, it is recommended that the user delete the "ds_globl.log", "ds_drv_?.log" and, as a last resort, the "ds_prog.def" files. The program will create the foregoing files if it does not find them and this may clear up any hangups should one or more of those files get messed up during a write file operation. Ver 3.10a (06 Feb 88) - Fixed problem of blank screen when returning from macro definitions (Alt-F10), directory links ("0"), and default definitions (ctrl-e). - Relaxed edit checks on color changes. Version 3.10 would not allow certain color monitors/adaptors to change color settings. Ver 3.20 (01 Jul 88) - Due to popular demand, have reinstated the "TAB <ltr>" option to work on tabbing/jumping to a 1st level directory whose name begins with <ltr>. The option of tabbing/jumping to a file will now be accomplished by "TAB TAB <ltr>". - Corrected problem with PS/2 MCGA video mode switching. - Added following macro options: %t = Insert names of all tagged files at this position of macro. Filename will not include filename extensions. %T = Insert names of all tagged files at this position of macro. Filename will include filename extensions. %1c = Execute a macro with tagged files only once even though the macro may run on to multiple lines due to the number of files tagged. The specified "c" character is the character to end each line (except the last) of the macro. Some programs would expect this character to be a "+". %O = Overlay DS program to execute the macro, thereby recovering about 83k of memory. DS program will be reloaded and executed upon termination of the macro. %X = Directly execute the command in the macro instead of executing macro through a command processor (command.com). This option is less desirable than executing thru a command processor, but available to try if the macro fails to work thru the command processor. Read the user's manual for a fuller description of the foregoing new macro options. - Enabled overlaying of DS program with following options: + Alt-L = List indicated file + Alt-E = Edit indicated file (old EGA toggle option) + Alt-X = Execute indicated file + Alt-C = Command Entry (old copy files option) These options will overlay the DS program, thereby recovering about 83k of memory. Upon completion of the specified activity the DS program will be reloaded and executed. Each of the above options have a counterpart option without the "ALT" key which does the same activity but without overlaying the DS program. The perferred and fastest method is the option without the "ALT" key, but if memory is in short supply the ALT- Option sequence may enable accomplishment of the desired activity when the perferred option is unable to complete the requested activity. With this option it is now most important that the user specify the complete pathname for the desired "editor" and "lister" programs (using the "ctrl-e" option) otherwise the "alt-l" and "alt-e" options will display the following rather misleading DOS error message: "run-time error R6005 -not enough memory on exec" This option has also caused the following options to change activation keys: + Copy Tagged Files is now Option "K" (vice alt-c) + 25 43/50 Line Mode Toggle is now Option "Alt-M" (vice alt-e) ┌────────────────────────────────────────────────┐ ──────────────┤ AUTHOR ├────────────── └────────────────────────────────────────────────┘ Nat Martino 501 W. Vineyard Ave. #514 Oxnard, CA 93030 (805) 485-6340 ┌────────────────────────────────────────────────┐ ──────────────┤ REGISTRATION/LICENSING ├────────────── └────────────────────────────────────────────────┘ * A $15 shareware contribution is requested for using the program. * The author retains the sole right to sell the program. * The author grants users the right to copy and distribute the program within the following constraints: - All program files remain unaltered and are distributed en masse. - Only the original "non-cloned" version of the program with the startup/termination and drive change time delays is distributed. - No attempt is made to sell the program, or to make money from it or any modified version of it. - The program is not bundled with any other hardware/software transactions without the author's permission. - Recognized users' groups may charge a maximum $5 duplication or distribution fee. * Continued use of the program (more than 2 weeks) by any individual, corporation or institution without a single-user or site license is prohibited. * Single-user licenses are obtained by sending in the $15 shareware contribution. * Corporations and other institutions (including government and educational) which desire using the program should refer to the "DS_SITE.LIC" file for site licensing information. ┌────────────────────────────────────────────────┐ ──────────────┤ DISCLAIMER ├────────────── └────────────────────────────────────────────────┘ The author disclaims all warranties expressed or implied as to the quality or performance of this program. The author will not be held liable for any lost profits, lost savings or any other direct, indirect, incidental or consequential damages resulting from the use of this program. Your use of this program constitutes your agreement to this disclaimer and your release of the author from any form of liability or litigation.